home *** CD-ROM | disk | FTP | other *** search
/ Aminet 43 / Aminet 43 (2001)(GTI - Schatztruhe)[!][Jun 2001].iso / Aminet / game / role / kangband.lha / Kangband292r2 / readme.txt < prev   
Text File  |  2001-04-22  |  14KB  |  308 lines
  1. This file is taken directly from standard Angband (version 2.9.2)
  2. ==========================================================================
  3.  
  4.  
  5.               **************************************************
  6.               **   Angband 2.9.2   **   The Pits of Angband   **
  7.               **************************************************
  8.  
  9.            Based on Moria:   Copyright (c) 1985 Robert Alan Koeneke
  10.                and Umoria:   Copyright (c) 1989 James E. Wilson
  11.  
  12.                        Angband 2.0 - 2.4 - 2.6.2 by:
  13.                    Alex Cutler, Andy Astrand, Sean Marsh,
  14.                  Geoff Hill, Charles Teague, Charles Swiger
  15.  
  16.                    Angband 2.7.0 - 2.8.5 by Ben Harrison
  17.  
  18.                  Angband 2.9.0 - 2.9.2 by Robert Ruehlmann
  19.  
  20.         Send comments, bug reports, and patches, to "rr9@angband.org"
  21.        Visit the Angband Home Page at "http://thangorodrim.angband.org/"
  22.       Browse the Angband newsgroup at "news:rec.games.roguelike.angband"
  23.     Read the online help files, especially "general.txt" and "version.txt"
  24.    Angband is available for Unix, X11, DOS, Windows, Macintosh, Amiga, etc.
  25.  
  26.  
  27. === General Info ===
  28.  
  29. This is the README file for Angband 2.9.2 (9th November 2000).
  30.  
  31. Angband is a "graphical" dungeon adventure game using textual characters
  32. to represent the walls and floors of a dungeon and the inhabitants therein,
  33. in the vein of "rogue", "hack", "nethack", and "moria".
  34.  
  35. There are some ascii "on line help" files in the "lib/help" directory.
  36.  
  37. See the Official Angband Home Page "http://thangorodrim.angband.org/" for
  38. a list (mostly complete) of what has changed in each recent version.
  39.  
  40. See the various Angband ftp sites (including "clockwork.dementia.org" and
  41. "ftp.cis.ksu.edu") for the latest files, patches, and executables.
  42.  
  43. Contact Robert Ruehlmann < rr9@angband.org > to report any bugs or to make
  44. any suggestions.  Use the newsgroup "rec.games.roguelike.angband" to ask
  45. any general questions about the game, including compilation questions.
  46.  
  47. This version of Angband will run on Macintosh, Windows, Unix (X11/Curses), 
  48. Linux (X11/Curses), Acorn, Amiga, various DOS machines, and many others...
  49.  
  50. See compile.txt, the Makefiles, h-config.h, and config.h for details on
  51. compiling.
  52. See "Makefile.xxx" and "main-xxx.c" for various supported systems.
  53.  
  54.  
  55. === Quick and dirty compilation instructions ===
  56.  
  57. For many platforms (including Macintosh and Windows), a "pre-compiled"
  58. archive is available, which contains everything you need to install and
  59. play Angband.  For other platforms, including most UNIX systems, you must
  60. compile the source code yourself.  Try the following non-trivial steps:
  61.  
  62. Step 1: Acquire.  Ftp to "clockwork.dementia.org:/angband/Source"
  63.                   Try "bin" and "mget angband*.tar.gz" and "y"
  64. Step 2: Extract.  Try "gunzip *.gz" then "tar -xvf *.tar"
  65. Step 3: Prepare.  Try "cd angband*/src", then edit "Makefile"
  66.                   You may also edit "h-config.h" and "config.h"
  67. Step 4: Compile.  Try "make", and then "cd .." if successful
  68. Step 5: Execute.  Try "angband -uTest" to initialize stuff
  69. Step 6: Play....  Read the "online help" via the "?" command.
  70.  
  71. Of course, if you have a compiler, you can compile a (possibly customized)
  72. executable on almost any system.  You will need the "source archive" (as
  73. above), which contains the standard "src" and "lib" directories, and for
  74. some platforms (including Macintosh and Windows), you will also need an
  75. appropriate "extra archive", which contains some extra platform specific
  76. files, and instructions about how to use them.  Some "extra archives" may
  77. be found at the ftp site (including "/angband/Macintosh/ext-mac.sit.bin"
  78. and "/angband/Windows/ext-win.zip"), but be sure that you get a version
  79. of the "extra archive" designed for Angband 2.9.0.
  80.  
  81.  
  82. === Special instructions for certain platforms ===
  83.  
  84. The Macintosh requires that the "lib" folder be in the same folder as
  85. the executable.  Also, note that System 7.5 (and perhaps others) are
  86. brain damaged, and may default to the incorrect folder for opening
  87. savefiles.  Make sure you keep all your savefiles in the proper place,
  88. and if you load a savefile from the wrong place, note that the game
  89. may decide to re-save your savefile in the proper place when you quit.
  90. If you move the "lib" folder (or any ancestor folder) while a game is
  91. in progress, you may not be able to save your game.  To use a savefile
  92. from another platform (or really old version of Angband) you must use
  93. the "Import..." menu command instead of the "Open..." menu command.
  94.  
  95. Some archive generation programs refuse to handle empty directories,
  96. so special "fake" files with names like "DELETEME.TXT" may have been
  97. placed into certain directories to avoid this problem.  You may safely
  98. delete these files if you so desire.
  99.  
  100.  
  101. === Upgrading from older versions (and/or other platforms) ===
  102.  
  103. If you have been using an older version of Angband (and/or playing on a
  104. different platform), you can "upgrade" (or "sidegrade") to Angband 2.9.0,
  105. bringing your old savefiles, high score list, and other files with you.
  106.  
  107. Angband 2.9.0 uses a platform independant file format for the binary files
  108. that store information about games in progress, known as "savefiles", and
  109. is able to translate savefiles from all known versions of Angband.  To use
  110. an "old" savefile, simply copy it into the "lib/save" directory, changing
  111. the name of the savefile (if necessary) to satisfy the requirements of the
  112. platform you are using.  In general, the savefile should be named "UUU.NNN"
  113. or "NNN" where "UUU" is the userid of the player (on "multiuser" systems),
  114. and "NNN" is the name of the "character" in the savefile.  Note that only
  115. "multiuser" platforms use the "UUU.NNN" form, and the "dot" is required.
  116.  
  117. Angband 2.9.0 uses a platform independant file format for the binary file
  118. used to store the high score list.  This file is named "scores.raw".  To
  119. use an "old" high score list, simply copy it into the "lib/apex" directory.
  120.  
  121. Angband 2.9.0 uses a set of special ascii "configuration files" which are
  122. kept in the "lib/file" directory.  These files should not be modified (or
  123. imported from older versions) unless you know exactly what you are doing,
  124. but often you can use "old" versions of these files with little trouble.
  125.  
  126. Angband 2.9.0 uses a set of ascii "user pref files" which are kept in the
  127. "lib/user" directory.  Most of these files can only be used on a small set
  128. of platforms, and may need slight modifications when imported from older
  129. versions.  Note that only some of these files are auto-loaded by the game.
  130.  
  131.  
  132. === Directory "src" ===
  133.  
  134. The "src" directory contains the complete set of "standard" source files.
  135.  
  136.  
  137. === Directory "lib" ===
  138.  
  139. The "lib" directory contains all of Angband's special sub-directories.
  140.  
  141.  
  142. === Directory "lib/apex" ===
  143.  
  144. The "lib/apex" directory contains the "high score" files.
  145.  
  146. The "scores.raw" file contains the "high score" table, in a "semi-binary" form,
  147. that is, all the bytes in the file are normal ascii values, but this includes
  148. the special "nul" or "zero" byte, which is used to separate and pad records.
  149. You should probably not attempt to modify this file with a normal text editor.
  150. This file should be (more or less) portable between different platforms.  It
  151. must be present (or creatable) for the game to run correctly.
  152.  
  153.  
  154. === Directory "lib/bone" ===
  155.  
  156. The "lib/bone" directory is currently unused.
  157.  
  158.  
  159. === Directory "lib/data" ===
  160.  
  161. The "lib/data" directory contains various special binary data files.
  162.  
  163. The files 'f_info.raw', 'k_info.raw', 'a_info.raw', 'e_info.raw', 'r_info.raw',
  164. and 'v_info.raw' are binary image files constructed by parsing the ascii
  165. template files in "lib/edit", described below.  These files are required,
  166. but can be created by the game if the "lib/edit" directory contains the
  167. proper files, and if the game was compiled to allow this creation.
  168.  
  169.  
  170. === Directory "lib/edit" ===
  171.  
  172. The "lib/edit" directory contains various special ascii data files.
  173.  
  174. The files 'f_info.txt', 'k_info.txt', 'a_info.txt', 'e_info.txt', 'r_info.txt',
  175. and 'v_info.txt' are ascii template files used to construct the binary image
  176. files in "lib/data", described above.  These files describe the "terrain
  177. features", "object kinds", "artifacts", "ego-items", "monster races", and
  178. "dungeon vaults", respectively.
  179.  
  180. The ascii template files are easier to edit than hard-coded arrays, and also
  181. prevent compilation errors on some machines, and also shrink the size of the
  182. binary executable, and also provide a user-readible spoiler file of sorts.
  183.  
  184. These files should not be modified unless you know exactly what you are doing.
  185.  
  186. These files are optional if the game is distributed with pre-created
  187. binary raw files in "lib/data".
  188.  
  189.  
  190. === Directory "lib/file" ===
  191.  
  192. The "lib/file" directory contains various special ascii data files.
  193.  
  194. The 'news.txt' file is displayed to the user when the game starts up.  It
  195. contains basic information such as my name and email address, and the names
  196. of some of the people who have been responsible for previous versions of
  197. Angband.  You may edit this file (slightly) to include local "site specific"
  198. information such as who compiled the local executable.  You should refer the
  199. user to a special "online help" file, if necessary, that describes any local
  200. modifications in detail.  The first two lines of this file should be blank,
  201. and only the next 20 lines should contain information.
  202.  
  203. The 'dead.txt' file is displayed to the user when the player dies.  It
  204. contains a picture of a tombstone which is filled in with interesting
  205. information about the dead player.  You should not edit this file.
  206.  
  207. The optional file 'wizards.txt' may be used to specify which users may enter
  208. 'wizard' mode.  A missing file provides no restrictions, and an empty file
  209. prevents everyone from entering 'wizard' mode.  This file is only used on
  210. multi-user machines, otherwise there are no restrictions.
  211.  
  212. The optional file 'time.txt' may be used to restrict the "times" at which
  213. the game may be played, by providing specification of which hours of each day
  214. of the week are legal for playing the game.  See 'files.c' for more details.
  215. A missing file provides no restrictions, and an empty file will, by default,
  216. forbid the playing of the game from 8am-5pm on weekdays.  This file is only
  217. used on multi-user machines, and only if CHECK_TIME is defined, otherwise,
  218. there are no restrictions.
  219.  
  220. The optional file 'load.txt' may be used to restrict the "load" which the game
  221. may impose on the system.  See 'files.c' for more details.  A missing file
  222. provides no restrictions, and an empty file will, by default, restrict the
  223. "current load" to a maximal value of 100*FSCALE.  This file is only used on
  224. multi-user machines, and only if CHECK_LOAD is defined, otherwise, there are
  225. no restrictions.
  226.  
  227. These files should not be modified unless you know exactly what you are doing.
  228.  
  229.  
  230. === Directory "lib/help" ===
  231.  
  232. The "lib/help" directory contains the "online help" files.
  233.  
  234. This directory is used to search for normal "online help" files.
  235.  
  236.  
  237. === Directory "lib/info" ===
  238.  
  239. The "lib/info" directory contains the "online spoiler" files.
  240.  
  241. This directory is used to search for any "online help" file that cannot
  242. be found in the "lib/help" directory.
  243.  
  244. This directory is empty by default.  Many people use this directory for
  245. "online spoiler files", many of which are available.
  246.  
  247. Note that the default "help.hlp" file allows the "9" key to access a help
  248. file called "spoiler.hlp", and allows the "0" key to access "user.hlp".
  249.  
  250. These special help files can thus be placed in the user's own "info"
  251. directory to allow the on line help to access his files.
  252.  
  253.  
  254. === Directory "lib/save" ===
  255.  
  256. The "lib/save" directory contains "savefiles" for the players.
  257.  
  258. Each savefile is named "NNN" where "NNN" is the name of the character, or,
  259. on some machines, the name of the character, or, on multi-user machines,
  260. "UUU.NNN", where "UUU" is the player uid and "NNN" is the character name.
  261.  
  262. The savefiles should be portable between systems, assuming that the
  263. appropriate renaming is perfomed.
  264.  
  265.  
  266. === Directory "lib/pref" ===
  267.  
  268. The "lib/user" directory contains the "user pref files", if any.
  269.  
  270. In general, these files are used to "customize" aspects of the game for
  271. a given site or a given player.
  272.  
  273. See "src/files.c" for information on the proper "format" of these files.
  274.  
  275.  
  276. === Directory "lib/xtra" ===
  277.  
  278. The "lib/xtra" directory contains special system files, if any.
  279.  
  280.  
  281.  
  282.  
  283. === NO WARRANTY ===
  284.  
  285.     BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
  286. FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
  287. OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
  288. PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
  289. OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  290. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
  291. TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
  292. PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
  293. REPAIR OR CORRECTION.
  294.  
  295.     IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  296. WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
  297. REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
  298. INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
  299. OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
  300. TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
  301. YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  302. PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
  303. POSSIBILITY OF SUCH DAMAGES.
  304.  
  305.  
  306. --- Ben Harrison and Robert Ruehlmann ---
  307.  
  308.